home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / misc~1 / 4 / cccomnd.doc < prev    next >
Text File  |  1986-02-25  |  4KB  |  84 lines
  1. CC.DOC
  2.  
  3. The following information is for version 1.1 of "cc".
  4. "cc" was written by Dave Clemans (November 1985).
  5.  
  6. "cc" is a program that acts as a frontend to the C compiler that comes
  7. with the Atari GEM toolkit.  It has builtin knowledge of the various
  8. parameters to pass to the pieces of the compiler, the order to call
  9. the various pieces, and of the specific ways to link object files to
  10. get the desired output.  It is modeled on the "cc" frontend that is
  11. associated with most Unix C compilers.
  12.  
  13. The flags to this version of "cc" don't necessarily match other versions
  14. because GEM seems to allow only one case.
  15.  
  16. "cc" knows how to use a RAM disk for temporary storage to speed up the
  17. compilation process.
  18.  
  19. By default, "cc" assumes that one drive (or hard disk directory) contains
  20. the C compiler, assembler, linker and libraries.  This requires either a
  21. double sided disk or a hard disk.  Alternatively, "cc" can be called twice;
  22. once to compile the source files, and once to link them.
  23.  
  24. This version assumes that the C compiler, assembler, linker, include files
  25. and libraries are all stored on drive A.  This can be overridden by the
  26. "-b" flag.  The location of the include files can be overridden by
  27. the "-i" flag.
  28.  
  29. "cc" links object files as a TOS application by default.  Files can
  30. be linked as GEM applications or as GEM desktop accessories by using
  31. the "-l" flag.  Hooks to use GEMDOS calls are always linked in.  Floating
  32. point support is not linked in unless one of the floating point flags
  33. "-e" or "-f" is given. (A floating point flag must be specified to use printf).
  34.  
  35. "cc" prints as little as possible by default; only error messages and the
  36. names of each file if multiple files are being compiled in one invocation
  37. of "cc".  If the "-v" flag is given, verbose messages are printed that
  38. tell what "cc" is doing at any point.
  39.  
  40. "cc" was linked with a version of the "gemstart" module modified to give
  41. about 40K bytes for stack and heap space.
  42.  
  43. The following is the message printed when you run the command "cc -help".
  44. cc: [flags] files ...
  45.   files ...
  46.     *.c     C files
  47.     *.s     ASM files
  48.     *.o     OBJECT files
  49.     others  pass to linker
  50.   flags ...
  51.     -a      compile to *.s file
  52.     -b dir  change bin directory
  53.     -c      compile to *.o file
  54.     -dname=value define name with value for preprocessor
  55.     -e      floating point (IEEE)
  56.     -f      floating point (FFP)
  57.     -h(elp) print this message
  58.     -i dir  change include directory
  59.     -la     link as GEM desk accessory
  60.     -lg     link as GEM program
  61.     -lt     link as TOS program
  62.     -o file put output file here
  63.     -p      preprocessor to *.i file
  64.     -q      preprocessor only to stdout
  65.     -r      rename to standard suffix
  66.     -s      strip symbol table from output
  67.     -t dir  change temp directory
  68.     -u(sage) print an usage message
  69.     -v      print verbose messages about what is happening
  70.     -w      ignore possible error messages
  71.     -x      cc command debugging output
  72.   defaults ...
  73.     BINDIR  A:  load compiler from here
  74.     INCDIR  A:  standard include files here
  75.     TMPDIR      build temp,output files here
  76.     a.prg       output file name
  77.                 output file will ALWAYS have suffix .prg
  78.                   unless -r is specified
  79.         output file MUST NOT be a directory path
  80.  
  81.     To use printf, specify -e or -f
  82.     Typing ^C will interrupt compilation
  84. ə